home *** CD-ROM | disk | FTP | other *** search
/ ShareWare OnLine 2 / ShareWare OnLine Volume 2 (CMS Software)(1993).iso / util1 / 4dos402p.zip / APPNOTES.DOC < prev    next >
Text File  |  1993-03-30  |  86KB  |  1,915 lines
  1.  
  2.                                   JP Software
  3.  
  4.                             4DOS Application Notes
  5.  
  6.                         Version 4.02 -- March 30, 1993
  7.  
  8.  
  9.    Copyright 1988 - 1993, JP Software Inc., All Rights Reserved.  Published
  10.    by JP Software Inc., P.O. Box 1470, E. Arlington, MA 02174 USA, (617)
  11.    646-3975.
  12.  
  13.  
  14.    This file provides information on using 4DOS with a variety of other
  15.    software products.  It is intended for use whenever you have a question
  16.    about using another product with 4DOS, or suspect a compatibility
  17.    problem.
  18.  
  19.    Inclusion of a product in this file does NOT mean there are
  20.    compatibility problems with it!  It only indicates that we have some
  21.    information that may be useful to you when you use the product with
  22.    4DOS.
  23.  
  24.    Items in this file which were changed in 4DOS 4.02 are marked with
  25.    "4.02" in the left margin.  Other items have not been changed since
  26.    version 4.01.
  27.  
  28.    This file is formatted at 58 lines per page, and contains form feeds and
  29.    page footers.  It is somewhat long, so you may prefer to view it with a
  30.    file viewer such as the 4DOS LIST command.  You can print this file on
  31.    most PC printers using the command:
  32.  
  33.               copy appnotes.doc prn
  34.  
  35.    Printing it with a program that formats the pages is not likely to work
  36.    due to the formatting included in the file.
  37.  
  38.    Our customers regularly ask us for recommendations on software to use
  39.    with 4DOS.  While we can't tell you what is best for your use or your
  40.    system, at the end of this file we have included some comments on
  41.    software we like and have found useful on our own systems here at JP
  42.    Software.
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.                                                                (3/93-4.02A)
  54.  
  55.  
  56.  
  57.    4DOS 4.02  [3-30-93]          APPNOTES.DOC                        page 1
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                Table of Contents
  64.  
  65.    Introduction  . . . . . . . . . . . . . . . . . . . . . . . . . . .    4
  66.  
  67.    General Information . . . . . . . . . . . . . . . . . . . . . . . .    5
  68.       Running 4DOS along with COMMAND.COM  . . . . . . . . . . . . . .    5
  69.       Executing DOS Commands from Your Applications: . . . . . . . . .    7
  70.       Swapping to RAM Disks  . . . . . . . . . . . . . . . . . . . . .    8
  71.       4DOS and Other Command Line Editing Programs . . . . . . . . . .    8
  72.       4DOS and EXE File Compression Programs . . . . . . . . . . . . .    9
  73.       Mouse Compatibility with 4DOS HELP . . . . . . . . . . . . . . .    9
  74.  
  75.    Information on Specific Products  . . . . . . . . . . . . . . . . .   10
  76.       MS-DOS APPEND Command  . . . . . . . . . . . . . . . . . . . . .   10
  77.       MS-DOS DATE and TIME Commands  . . . . . . . . . . . . . . . . .   11
  78.       MS-DOS FASTOPEN Command  . . . . . . . . . . . . . . . . . . . .   12
  79.       MS-DOS 4.0 and 5.0 FORMAT /S and SYS Command . . . . . . . . . .   12
  80.       MS-DOS 6.0 MOVE Command  . . . . . . . . . . . . . . . . . . . .   12
  81.       MS-DOS 4.0 and 5.0 SELECT Command  . . . . . . . . . . . . . . .   13
  82.       MS-DOS 6.0 MEMMAKER Command  . . . . . . . . . . . . . . . . . .   13
  83.       1DIR+ (Bourbaki) . . . . . . . . . . . . . . . . . . . . . . . .   13
  84.       3COM Networks (3Com) . . . . . . . . . . . . . . . . . . . . . .   14
  85.       AllClear (AllClear Software) . . . . . . . . . . . . . . . . . .   14
  86.       Alpha 4 (Alpha Software) . . . . . . . . . . . . . . . . . . . .   15
  87.       ANSI.SYS (various manufacturers) . . . . . . . . . . . . . . . .   15
  88.       Bookshelf CD-ROM (Microsoft) . . . . . . . . . . . . . . . . . .   15
  89.       DESQview (Quarterdeck) . . . . . . . . . . . . . . . . . . . . .   15
  90.       DOORWAY BBS Software . . . . . . . . . . . . . . . . . . . . . .   17
  91.       DR-DOS (Digital Research)  . . . . . . . . . . . . . . . . . . .   17
  92.       Epsilon (Lugaru Software)  . . . . . . . . . . . . . . . . . . .   21
  93.       Extra! 3270 Emulator . . . . . . . . . . . . . . . . . . . . . .   21
  94.       FoxPro (Microsoft) . . . . . . . . . . . . . . . . . . . . . . .   21
  95.       Hijaak (Inset Systems) . . . . . . . . . . . . . . . . . . . . .   21
  96.       LapLink (Traveling Software) . . . . . . . . . . . . . . . . . .   22
  97.       LOGIMENU (Logitech)  . . . . . . . . . . . . . . . . . . . . . .   22
  98.       Manifest (Quarterdeck) . . . . . . . . . . . . . . . . . . . . .   22
  99.       Netware (Novell) . . . . . . . . . . . . . . . . . . . . . . . .   22
  100.       Novell MENU (Novell) . . . . . . . . . . . . . . . . . . . . . .   25
  101.       OS/2 1.2, 1.3, and 2.0 (IBM / Microsoft) . . . . . . . . . . . .   25
  102.       OS2SPEED DOS Sessioon Enhancer . . . . . . . . . . . . . . . . .   25
  103.       Personal REXX (Quercus Systems)  . . . . . . . . . . . . . . . .   26
  104.       QEMM and QRAM (Quarterdeck)  . . . . . . . . . . . . . . . . . .   27
  105.       RBase (MicroRim) . . . . . . . . . . . . . . . . . . . . . . . .   28
  106.       RoboComm Communications Software . . . . . . . . . . . . . . . .   28
  107.       Software Carousel (SoftLogic Solutions)  . . . . . . . . . . . .   28
  108.       TSRCOM Utilities (TurboPower Software) . . . . . . . . . . . . .   29
  109.       UltraVision (Personics)  . . . . . . . . . . . . . . . . . . . .   29
  110.       Windows 3.0 and 3.1 (Microsoft)  . . . . . . . . . . . . . . . .   30
  111.       XyWrite (XyQuest)  . . . . . . . . . . . . . . . . . . . . . . .   30
  112.  
  113.  
  114.  
  115.    4DOS 4.02  [3-30-93]          APPNOTES.DOC                        page 2
  116.  
  117.  
  118.       Programs Requiring PATH to be Under 128 Characters . . . . . . .   30
  119.           Checkit (Touchstone); Computer Select CD-ROM (Ziff-Davis);
  120.           RenderMan (AutoDesk); VINES Network (Banyan); Windows 3.0
  121.           (Microsoft)
  122.  
  123.    Software For Use With 4DOS  . . . . . . . . . . . . . . . . . . . .   32
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.    4DOS 4.02  [3-30-93]          APPNOTES.DOC                        page 3
  174.  
  175.  
  176.  
  177.    Introduction
  178.    ------------
  179.  
  180.    We have made every effort to ensure that this file is as accurate and up
  181.    to date as possible.  Our information is based on our own
  182.    investigations, reports from 4DOS beta testers, technical support calls,
  183.    discussions with manufacturers of other products, and reports from our
  184.    customers.  Unfortunately, varying conditions between systems or between
  185.    software releases can easily invalidate the results of previous tests. 
  186.    Therefore we cannot guarantee that every item in this file is accurate
  187.    for all systems or will remain accurate over time; you may have to do
  188.    your own testing to determine what works well on your system with the
  189.    software you own.
  190.  
  191.    If you have a question or problem related to another program, first read
  192.    through chapter 7 of the 4DOS manual ("Using 4DOS With Your Hardware And
  193.    Software").  Chapter 7 gives general suggestions for using 4DOS with
  194.    other products and for solving compatibility problems, and should always
  195.    be used along with this file.
  196.  
  197.    If the information in Chapter 7 doesn't help, check below for both
  198.    additional general suggestions which pertain to your question, and
  199.    information on the specific product you are working with.  Please note
  200.    that some products are listed by category rather than or in addition to
  201.    specific listings by product name; check the Table of Contents carefully
  202.    to see where any particular product may be covered.
  203.  
  204.    Many of the items below refer to the 4DOS.INI file.  See chapter 6 of
  205.    the manual for a complete explanation of 4DOS.INI and the directives
  206.    which can be used there.  If you have a printed manual, also check
  207.    MANMOD.DOC for directives which were added or modified since the manual
  208.    went to press.
  209.  
  210.    Virtually all of your software will work with 4DOS with no trouble.  If
  211.    you do find an interaction or compatibility problem, it can probably be
  212.    diagnosed easily with one of three methods:  checking this file for
  213.    specific information; trying different 4DOS swapping methods; and
  214.    testing for interactions by removing all drivers and TSRs which are not
  215.    absolutely necessary and then replacing them one at a time.  These
  216.    methods and other related techniques are described in Chapter 7 of the
  217.    manual.
  218.  
  219.    Many popular software products are not covered in this file.  If a
  220.    program does not appear here, it simply means that as far as we know no
  221.    additional information is necessary or useful when using that program
  222.    with 4DOS.
  223.  
  224.    If you have a question or problem related to how 4DOS works with other
  225.    hardware or software products, and it isn't addressed in chapter 7 or by
  226.    these notes, contact JP Software or your dealer for technical support.
  227.  
  228.  
  229.  
  230.  
  231.    4DOS 4.02  [3-30-93]          APPNOTES.DOC                        page 4
  232.  
  233.  
  234.  
  235.    General Information
  236.    -------------------
  237.  
  238.       Running 4DOS along with COMMAND.COM:
  239.  
  240.           You may find a very rare program which will not work under 4DOS,
  241.           but runs properly under COMMAND.COM.  If you have determined that
  242.           the problem cannot be solved through configuration changes or by
  243.           eliminating or reconfiguring a third program which is causing the
  244.           problem, use this section to see how to run 4DOS and COMMAND.COM
  245.           together in order to diagnose such a problem.
  246.  
  247.           There are two methods of loading COMMAND.COM before another
  248.           program.  The first is to load it only when a specific program is
  249.           running.  This can be accomplished with the following command
  250.           (assuming COMMAND.COM is in the root directory of drive C:):
  251.  
  252.                     c:\command /c progname options
  253.  
  254.           where "progname" is the program name (with path if necessary) and
  255.           "options" are any parameters for the program.  This command will
  256.           run COMMAND.COM, load and run the program, and upon exit from the
  257.           program will exit from COMMAND.COM and return to 4DOS.  If this
  258.           is necessary to run a specific program, it can be defined as an
  259.           alias:
  260.  
  261.                     alias progname `c:\command /c progname %&`
  262.  
  263.           The "%&" passes all command line arguments on to the program.
  264.  
  265.           With this method, if the program is large COMMAND.COM may need to
  266.           reload itself when the program exits.  It will not be able to do
  267.           so unless the COMSPEC is set properly.  If you experience
  268.           problems such as "Invalid COMMAND.COM" errors when using this
  269.           method, use a batch file like the following to run the program in
  270.           question (the SETLOCAL and ENDLOCAL cause COMSPEC to be restored
  271.           to its previous value after the program exits).  You will need to
  272.           modify this file if your copy of COMMAND.COM is not stored in the
  273.           C:\ directory:
  274.  
  275.                     setlocal
  276.                     set comspec=C:\COMMAND.COM
  277.                     c:\command /c progname %&
  278.                     endlocal
  279.  
  280.           The second method is more drastic:  you can start your system
  281.           under COMMAND.COM, then run 4DOS.  This approach is rarely
  282.           necessary, and will use about 4 - 5K of additional RAM for the
  283.           resident portion of COMMAND.COM.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.    4DOS 4.02  [3-30-93]          APPNOTES.DOC                        page 5
  290.  
  291.  
  292.           The following steps will set your system up to boot with
  293.           COMMAND.COM, and run 4DOS automatically as part of the boot
  294.           process:
  295.  
  296.               (1) Set up the SHELL= statement in CONFIG.SYS to run
  297.               COMMAND.COM, or leave it out entirely.  In other words, set
  298.               it up just as you would if 4DOS were not on your system.
  299.  
  300.               (2) Separate your AUTOEXEC file into two parts:  part 1,
  301.               which remains in AUTOEXEC.BAT, should contain any commands
  302.               you wish to have COMMAND.COM execute before 4DOS is started. 
  303.               This might include loading any TSRs which you cannot get to
  304.               load properly under 4DOS.  Part 2, which you must place in a
  305.               separate batch file (we suggest the name 4DAUTO.BAT, but you
  306.               can use any name with a .BAT or .BTM extension), should
  307.               contain the commands you wish to have 4DOS execute when it is
  308.               started.
  309.  
  310.               (3) Place the following line as the last line in the modified
  311.               AUTOEXEC.BAT:
  312.  
  313.                     4DOS parameters filename
  314.  
  315.               where "parameters" represents the appropriate 4DOS parameters
  316.               for swapping, environment and history size, etc. (see the
  317.               Installation section of the manual), and "filename" is the
  318.               name of the new batch file you created for part 2 of your old
  319.               AUTOEXEC file.  Do NOT include a /P in the "parameters" or
  320.               4DOS will re-run AUTOEXEC and therefore load itself again, ad
  321.               infinitum!
  322.  
  323.               (4) Be sure that KSTACK.COM is loaded in your AUTOEXEC.BAT
  324.               file or your 4DOS startup file if you wish to use the 4DOS
  325.               KEYSTACK command.
  326.  
  327.           This will load COMMAND.COM, execute the commands in AUTOEXEC,
  328.           load 4DOS, execute the commands in your new batch file, and then
  329.           give you the normal 4DOS prompt.
  330.  
  331.           There is one drawback to this second approach:  because 4DOS is
  332.           not loaded with a /P, the EXIT command will return you to
  333.           COMMAND.COM if you inadvertently enter it at the primary shell
  334.           prompt.  You can get around this by including the /P parameter
  335.           despite the caution above, and then placing the following line at
  336.           the start of AUTOEXEC.BAT:
  337.  
  338.                     if "%@eval[2+2]"=="4" quit
  339.  
  340.           This line tests the 4DOS variable function %@EVAL, which will
  341.           return "4" under 4DOS and remain unchanged under COMMAND.COM.  If
  342.           %@EVAL returns a "4" the statement QUITs the batch file,
  343.           preventing the infinite loop described above.
  344.  
  345.  
  346.  
  347.    4DOS 4.02  [3-30-93]          APPNOTES.DOC                        page 6
  348.  
  349.  
  350.  
  351.  
  352.       Executing DOS Commands from Your Applications:
  353.  
  354.    4.02   In general you should have no trouble running DOS commands or
  355.           "shelling to DOS" from within your applications.  If you do,
  356.           first follow the instructions in Chapter 7 of the manual, check
  357.           your COMSPEC setting, and check that enough memory is available
  358.           for 4DOS to execute as a secondary shell.
  359.  
  360.           If those techniques do not resolve the problem, it may be due to
  361.           one of the issues covered below:  either the application was
  362.           developed with a compiler that does not handle the format of
  363.           4DOS.COM properly, or it is using interrupt 2E and you have
  364.           disabled interrupt 2E support.
  365.  
  366.           Compilers and the Format of 4DOS.COM:
  367.  
  368.               If you have an application which can run DOS commands from
  369.               inside the application and that particular feature does not
  370.               work, try to determine if the application was developed with
  371.               Borland C or Lattice C.  Some versions of these compilers
  372.               cannot properly execute 4DOS.COM to start a secondary shell,
  373.               because 4DOS.COM (despite its name) is really an EXE file,
  374.               and the libraries shipped with these compilers do not use the
  375.               proper method to determine what type of file they are
  376.               running.
  377.  
  378.               If you suspect sucha problem, make a copy of 4DOS.COM named
  379.               4DOS.EXE, and SET your COMSPEC variable to this file, for
  380.               example:
  381.  
  382.                     d:\4dos> copy 4dos.com 4dos.exe
  383.                     d:\4dos> set comspec=d:\4dos\4dos.exe
  384.  
  385.               Then run the application in question and see if it works.  If
  386.               so, you can use the above workaround to run the application. 
  387.               Be sure to contact the application vendor to see if they have
  388.               an update which corrects this problem.
  389.  
  390.               For users of Borland C and C++, a fix is available for this
  391.               problem (the fix updates certain functions in the Borland C
  392.               run-time library).  You can download this fix from the
  393.               Borland support area on CompuServe, and it is distributed
  394.               with newer copies of the Borland compilers.
  395.  
  396.           Re-Enabling Interrupt 2E Support:
  397.  
  398.               COMMAND.COM contains an undocumented feature which allows
  399.               programs to execute DOS commands by passing the command
  400.               through software interrupt number 2E (hex).  Very few
  401.               programs use this feature, but full, documented support for
  402.  
  403.  
  404.  
  405.    4DOS 4.02  [3-30-93]          APPNOTES.DOC                        page 7
  406.  
  407.  
  408.               it is available within 4DOS for those circumstances where
  409.               it's needed.
  410.  
  411.               Interrupt 2E support is normally enabled within 4DOS, but can
  412.               be disabled to save memory (INT 2E support requires about 100
  413.               bytes of resident memory).
  414.  
  415.               If you have a program which is supposed to execute DOS
  416.               commands and it does not work under 4DOS, check your 4DOS.INI
  417.               file.  If you see a line like this:
  418.  
  419.                     FullINT2E = No
  420.  
  421.               then you have disabled INT 2E support.  If the line is there,
  422.               try removing this line or replacing it with one reading:
  423.  
  424.                     FullINT2E = Yes
  425.  
  426.               to re-enable support for interrupt 2E, then chcek whether
  427.               your program works properly.
  428.  
  429.               See Appendix C of the ASCII manual, or the MANMOD.DOC file if
  430.               you have a printed manual, for technical details on the INT
  431.               2E interface.
  432.  
  433.  
  434.       Swapping to RAM Disks:
  435.  
  436.           In order to swap the primary shell to a RAM disk the RAM disk
  437.           must be completely defined in CONFIG.SYS via a DEVICE= statement
  438.           (most RAM disks are set up this way).  RAM disks completely or
  439.           partially defined in AUTOEXEC.BAT (such as the RAM disk / cache
  440.           combination in Multisoft's PC Kwik Power Pak) cannot be used for
  441.           swapping the primary shell, because AUTOEXEC.BAT has not been
  442.           executed at the time that the root shell is loaded, and hence the
  443.           RAM disk does not exist at that point.
  444.  
  445.  
  446.       4DOS and Other Command Line Editing Programs:
  447.  
  448.           Programs such as Anarkey (Moderne Software), PCED (Cove
  449.           Software), and ReDOS (Multisoft) will work properly with 4DOS. 
  450.           However these programs require the use of SETDOS /L1 to operate,
  451.           which will disable 4DOS's command recall and command line
  452.           editing.  In most cases you will be able to switch back and forth
  453.           between 4DOS editing and the other editor by toggling the SETDOS
  454.           /L state.
  455.  
  456.           When another editor is used 4DOS's command history will be
  457.           maintained, and can be viewed with HISTORY, but will not be
  458.           available for recall until a SETDOS /L0 is executed.  4DOS
  459.           aliases, executable extensions, and other features will be active
  460.  
  461.  
  462.  
  463.    4DOS 4.02  [3-30-93]          APPNOTES.DOC                        page 8
  464.  
  465.  
  466.           regardless of the SETDOS /L state.  Aliases will be processed
  467.           after any processing done by the other editing program.  You must
  468.           use care with other programs that provide an aliasing capability
  469.           to avoid confusion if a command is expanded by both the other
  470.           program and 4DOS!
  471.  
  472.  
  473.       4DOS and EXE File Compression Programs:
  474.  
  475.           If you use a file compression program like PKLITE, LZEXE, or
  476.           DIET, you must use caution when compressing 4DOS files.  Most
  477.           such programs should be able to compress the 4DOS.COM file with
  478.           no trouble.  However if you have a copy of 4DOS that you intend
  479.           to brand with your name and serial number, you must brand it
  480.           BEFORE you run the file compression program, or the BRAND program
  481.           will fail.  Similarly, HELPCFG will not be able to modify your
  482.           HELP system colors if you compress the 4HELP.EXE program.  The
  483.           only compressed program files distributed with 4DOS are
  484.           HELPCFG.EXE, and 4MAKE.EXE on the 4DOS / 4OS2 Utility Disk; these
  485.           files are compressed with the PKLite Professional package.
  486.  
  487.  
  488.       Mouse Compatibility with 4DOS HELP:
  489.  
  490.           The 4DOS HELP system depends on correct operation of your mouse
  491.           driver.  If your mouse doesn't work in HELP, or you have trouble
  492.           with mouse "droppings" (characters left behind by the mouse
  493.           cursor), be sure you have the most up to date working version of
  494.           your mouse driver that is available.
  495.  
  496.           Users of Microsoft serial and PS/2 mice may notice a long delay
  497.           when the HELP system starts.  This is due to the long
  498.           initialization time required for these mice, and is a function of
  499.           the mouse driver, not the HELP system.  If you don't use the
  500.           mouse in HELP and want to speed up HELP startup, set
  501.           HelpOptions = /X in 4DOS.INI.  This will disable all mouse access
  502.           in the HELP system.
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.    4DOS 4.02  [3-30-93]          APPNOTES.DOC                        page 9
  522.  
  523.  
  524.  
  525.    Information on Specific Products
  526.    --------------------------------
  527.  
  528.    The information below is listed alphabetically by product, with
  529.    manufacturers' names included.  MS-DOS commands are listed before other
  530.    software products.
  531.  
  532.    Items marked with two asterisks [**] after the product name were
  533.    supplied by users, and have not been tested by JP Software.
  534.  
  535.  
  536.       MS-DOS APPEND Command:
  537.  
  538.           Unlike most other commands in MS-DOS, APPEND has both an external
  539.           portion and an undocumented internal portion.  The first time
  540.           APPEND is run the external portion is executed, and loaded into
  541.           memory as a TSR (memory-resident program).  Subsequent uses of
  542.           APPEND to adjust the APPEND path use an undocumented internal
  543.           interface between COMMAND.COM and the TSR portion of APPEND.
  544.  
  545.           4DOS does not support the internal portion of APPEND command. 
  546.           This means that you cannot change the APPEND path directly from
  547.           4DOS.  However you can still use APPEND with 4DOS.
  548.  
  549.           APPEND should initially be loaded in the usual way, from AUTOEXEC
  550.           or any other batch file, or from the command line.  However to
  551.           change the APPEND path after APPEND has been loaded for the first
  552.           time, you must run APPEND from COMMAND.COM, not from 4DOS.  To do
  553.           this, enter the following command (modify the command
  554.           appropriately if COMMAND.COM is not in the directory C:\):
  555.  
  556.                     c:\command /c append [new append path list]
  557.  
  558.           You could also set up a 4DOS alias to do the above command for
  559.           you, for example:
  560.  
  561.                     alias app `c:\command /c append`
  562.  
  563.           which would be invoked with the command
  564.  
  565.                     app [new path list]
  566.  
  567.           The /X switch can be used, and it will affect 4DOS directory
  568.           searches for many 4DOS commands (as it does for COMMAND.COM). 
  569.           Please note that this makes APPEND very dangerous:  if you APPEND
  570.           a directory with /X and then (say) delete *.BAK when no such
  571.           files exist in the current directory, then the .BAK files in the
  572.           APPENDed directory will be deleted instead.
  573.  
  574.           The APPEND /E switch will not work with 4DOS.
  575.  
  576.  
  577.  
  578.  
  579.    4DOS 4.02  [3-30-93]          APPNOTES.DOC                       page 10
  580.  
  581.  
  582.       !   CAUTION:  In our opinion APPEND is an extremely dangerous
  583.           command.  It is capable of "fooling" programs into thinking they
  584.           are accessing one file when they are really accessing another one
  585.           with the same name in a different directory.  This can either do
  586.           just what you want, or cause all sorts of trouble, depending on
  587.           the circumstances.  In particular, this behavior can cause 4DOS
  588.           to place descriptions which go with files in one directory in the
  589.           description file for another directory, because with APPEND
  590.           running 4DOS can't tell whether APPEND has opened a file
  591.           different from the one it asked for.
  592.  
  593.           If you must use APPEND to make certain applications work, we
  594.           STRONGLY suggest that you set up the aliases described above, and
  595.           load APPEND in AUTOEXEC.BAT with an empty path.  Then, for each
  596.           application, set up an alias to run it that is similar to the
  597.           following:
  598.  
  599.               alias myprog `app c:\mydata^d:\util\myprog.exe^app ;`
  600.  
  601.           This alias sets the APPEND path, runs the application, and clears
  602.           the APPEND path.  When used in this way APPEND is less likely to
  603.           cause trouble because it is disabled except when it is explicitly
  604.           needed.
  605.  
  606.    4.02   In MS-DOS 4.0 and above, and in OS/2 2.x, the APPEND /PATH:OFF
  607.           switch mitigates this problem somewhat; in particular it will
  608.           keep 4DOS file description files from getting mixed up between
  609.           directories.  For this reason 4DOS will automatically set this
  610.           switch if it detects that you are running APPEND and DOS 4.0 or
  611.           above.
  612.  
  613.  
  614.       MS-DOS DATE and TIME Commands:
  615.  
  616.           Most PC systems automatically set the hardware clock date and
  617.           time (which is maintained while the system is turned off, and is
  618.           different from the DOS date and time) when the corresponding DOS
  619.           command is executed.  In most such cases the hardware
  620.           manufacturer has implemented this capability within the BIOS
  621.           built into the system.  This type of implementation is compatible
  622.           with 4DOS, and the 4DOS DATE and TIME commands will set the
  623.           hardware clock properly.
  624.  
  625.           A very small number of manufacturers have modified the version
  626.           COMMAND.COM which they sell with their PCs to perform this
  627.           function.  In these cases, 4DOS's DATE and TIME commands, which
  628.           do not have such hardware-specific modifications, will not set
  629.           the hardware clock.  If you normally set the hardware clock's
  630.           date and time with DOS commands, and they don't work under 4DOS,
  631.           first check your clock's battery!  If it's OK, either run a
  632.           secondary copy of COMMAND.COM to set the date and time, or invoke
  633.           your system's SETUP or other utility program to do so.
  634.  
  635.  
  636.  
  637.    4DOS 4.02  [3-30-93]          APPNOTES.DOC                       page 11
  638.  
  639.  
  640.  
  641.       MS-DOS FASTOPEN Command:
  642.  
  643.           The MS-DOS FASTOPEN command generally works with 4DOS, but does
  644.           not properly detect renamed directories, and may have similar
  645.           problems when directories are removed.  This is a problem in
  646.           FASTOPEN, not in 4DOS.  If you use FASTOPEN and rename a
  647.           directory with the 4DOS REN command, then do a DIR command, you
  648.           may see the old name and not the new one displayed; you may also
  649.           occasionally have trouble accessing files under the new name. 
  650.           You can usually solve this problem by including a DiskReset = Yes
  651.           directive in 4DOS.INI.  If DiskReset = Yes does not work, the
  652.           only other solution we are aware of is to reboot your system
  653.           after renaming a directory.
  654.  
  655.           Our opinion is that, if you have the memory to support it, a disk
  656.           caching program will provide a much greater and more effective
  657.           performance improvement than FASTOPEN.
  658.  
  659.  
  660.       MS-DOS 4.0 and 5.0 FORMAT /S and SYS Commands:
  661.  
  662.    4.02   The FORMAT /S and SYS commands in DOS 4 and DOS 5 will copy
  663.           4DOS.COM to a newly formatted floppy disk and rename it
  664.           COMMAND.COM, which may not be what you want and is confusing at
  665.           best.  See the discussion of "4DOS and DOS" in Chapter 7 of the
  666.           manual for more information on this issue.  This problem has been
  667.           addressed in MS-DOS 6.0, where the FORMAT /S and SYS commands
  668.           will properly copy COMMAND.COM to the floppy disk even when 4DOS
  669.           is the command processor.
  670.  
  671.  
  672.       MS-DOS 6.0 MOVE Command:
  673.  
  674.    4.02   MS-DOS 6 includes an external MOVE command which is generally
  675.           compatible with the 4DOS MOVE command.
  676.  
  677.           The syntax and features of the MS-DOS 6 MOVE command are slightly
  678.           different than those offered by 4DOS's MOVE, so batch files
  679.           written for one command may not work exactly the same way with
  680.           the other, especially if more advanced or complex features are
  681.           used.  If you write batch files which use both commands, check
  682.           the 4DOS and MS-DOS 6 documentation for your particular usage.
  683.  
  684.           One difference is that, unlike 4DOS, the MS-DOS 6 MOVE command
  685.           will rename directories if the source refers to a directory, the
  686.           destination name is in the same path, and the destination
  687.           directory does not exist.  For example, if you enter this
  688.           command:
  689.  
  690.                     c:\data> move olddir newdir
  691.  
  692.  
  693.  
  694.  
  695.    4DOS 4.02  [3-30-93]          APPNOTES.DOC                       page 12
  696.  
  697.  
  698.           when OLDDIR exists and NEWDIR does not, then MS-DOS 6 MOVE will
  699.           rename OLDDIR to NEWDIR, whereas 4DOS will treat NEWDIR as a
  700.           destination file name (not a directory name).  If you use
  701.           MOVE /D, 4DOS will treat NEWDIR as a directory name, and prompt
  702.           you for whether to create the directory, but 4DOS will not rename
  703.           OLDDIR automatically as MS-DOS 6 MOVE will.  For more details on
  704.           how 4DOS MOVE handles destination names, see MOVE in the 4DOS
  705.           manual or online help.
  706.  
  707.  
  708.       MS-DOS 4.0 and 5.0 SELECT Command:
  709.  
  710.           In MS-DOS 4.0 and 5.0, a SELECT command was included.  This
  711.           external command is totally unrelated to the 4DOS internal SELECT
  712.           command.  If you need to use both, you can set up aliases to
  713.           adjust how the command names are handled.  For example, the
  714.           following two aliases set up SELECT to access the DOS 4.0
  715.           external SELECT command (assumed to be stored in
  716.           C:\DOS\SELECT.EXE), and SEL to access the internal 4DOS SELECT
  717.           command:
  718.  
  719.                     alias select c:\dos\select.exe
  720.                     alias sel *select
  721.  
  722.  
  723.       MS-DOS 6.0 MEMMAKER Command:
  724.  
  725.    4.02   4DOS 4.02 is fully compatible with MemMaker.  MemMaker adds
  726.           commands to the end of your AUTOEXEC.BAT file during its
  727.           operation, and removes them when it is finished.  If for some
  728.           reason you have used a QUIT command in AUTOEXEC.BAT, remove it
  729.           before running MemMaker.  Otherwise, MemMaker's commands will not
  730.           run and the memory optimization process will not work properly.
  731.  
  732.  
  733.       1DIR+ (Bourbaki):
  734.  
  735.           The information below was obtained from tests with 1DIR+ version
  736.           3.02, and verified with version 3.5 as well.
  737.  
  738.           1DIR+ will work properly under 4DOS in its partially resident or
  739.           EMS modes when set up as described below.  It will work in its
  740.           fully resident mode but cannot reliably exit back to 4DOS once
  741.           started.
  742.  
  743.           If your copy of 1DIR+ is set up for fully resident mode, you can
  744.           load it into memory under 4DOS to switch it to partially resident
  745.           or EMS mode.  To do so, from the directory where you normally run
  746.           1DIR+, type the commands:
  747.  
  748.                     setdos /l1
  749.                     1dirplus
  750.  
  751.  
  752.  
  753.    4DOS 4.02  [3-30-93]          APPNOTES.DOC                       page 13
  754.  
  755.  
  756.           When 1DIR+ starts go to the "Wonder" / "Setup" menu and switch
  757.           the mode to partially resident or EMS.  Hit Esc to exit, and take
  758.           the "Exit/Save" option (not "Save/Reset").  Back at the main
  759.           menu, exit with "Wonder" / "Exit".  At this point the system will
  760.           probably hang.  Reboot your computer.  You should then be able to
  761.           run 1DIR+ as described below.
  762.  
  763.           The above steps only need to be done once, when you install or
  764.           re-install 1DIR+.
  765.  
  766.           Once 1DIR+ is set to EMS or partially-resident mode, you can
  767.           start it from 4DOS using the following alias:
  768.  
  769.                     alias 1dir `setdos /L1 ^ 1dirplus`
  770.  
  771.           The SETDOS /L1 is necessary to allow 1DIR+ to send command lines
  772.           to 4DOS.
  773.  
  774.           You must do a SETDOS /L0 when you are done with 1DIR+ in order to
  775.           get normal 4DOS command-line editing back.  You can NOT do this
  776.           within the alias above, as 1DIR+ returns to 4DOS in order to
  777.           accomplish its work, and you don't want to switch back to /L0
  778.           mode until 1DIRPLUS has been removed from memory.  If, after
  779.           exiting from 1DIR+, you find that 4DOS's command line editing and
  780.           history are unavailable, it is because you forgot to do the
  781.           SETDOS /L0.  If you go in and out of 1DIR+ regularly aliases like
  782.           the following can be used to make the process quick:
  783.  
  784.                     alias 1d `setdos /L1 ^ 1dirplus`
  785.                     alias 1e setdos /L0
  786.  
  787.           If you run batch files from the 1DIRPLUS "compose" feature, you
  788.           may find that INPUT commands in the batch file don't work
  789.           properly unless they are preceded by SETDOS /L0.  You must also
  790.           do a SETDOS /L1 before the end of the batch file, or 1DIRPLUS
  791.           won't pop up properly when the batch file is finished.  For
  792.           example:
  793.  
  794.                     setdos /l0
  795.                     input Enter your name:  %%name
  796.                     setdos /l1
  797.  
  798.  
  799.       3COM Networks (3Com):  [**]
  800.  
  801.           Some users report that 3Com network software will not load
  802.           properly if UMBLoad = Yes is used in 4DOS.INI.  If you have
  803.           trouble with a 3Com network and 4DOS, try removing the UMBLoad
  804.           and UMBEnvironment directives from your 4DOS.INI file.
  805.  
  806.  
  807.       AllClear (AllClear Software):  [**]
  808.  
  809.  
  810.  
  811.    4DOS 4.02  [3-30-93]          APPNOTES.DOC                       page 14
  812.  
  813.  
  814.    4.02   AllClear may not work properly under 4DOS unless if it is invoked
  815.           with a simple program name, such as A.COM.  However it works
  816.           properly if invoked with its full path name, for example
  817.           D:\ALLCLEAR\A.COM.  If you use AllClear, you can set up an alias
  818.           to do this, for example:
  819.  
  820.               alias ac d:\allclear\a.com
  821.  
  822.  
  823.       Alpha 4 (Alpha Software):  [**]
  824.  
  825.           Alpha 4 does not work properly if you have too much environment
  826.           space in use when it is started.  You can use the 4DOS SETLOCAL,
  827.           ENDLOCAL, and UNSET commands to decrease the amount of
  828.           environment space in use before starting Alpha 4.  For details on
  829.           this technique see the section on "Solving Software Compatibility
  830.           Problems" in chapter 7 of the 4DOS manual.
  831.  
  832.  
  833.       ANSI.SYS (various manufacturers):
  834.  
  835.           If you have trouble with screen scrolling in 43-line or 50-line
  836.           mode, try a different version of ANSI.  We have had good results
  837.           with PC Magazine's free utility ANSI.COM, and with the ANSI-
  838.           UV.SYS program distributed with Personics' UltraVision EGA / VGA
  839.           enhancement software.
  840.  
  841.           Some display-related device drivers may "fool" 4DOS into thinking
  842.           an ANSI driver is present when this is not the case.  If this
  843.           happens you will see ANSI strings like "[2J" displayed on-screen
  844.           when you use the CLS and COLOR commands.  To correct the problem,
  845.           place an ANSI = No directive in 4DOS.INI, or a SETDOS /A2 command
  846.           in AUTOEXEC.BAT.
  847.  
  848.  
  849.       Bookshelf CD-ROM (Microsoft):  [**]
  850.  
  851.           Microsoft Bookshelf uses the environment variable CDPATH, which
  852.           is also used (for a totally different purpose) by 4DOS.  If you
  853.           are using MS Bookshelf and want to set a CDPATH variable for
  854.           4DOS, set _CDPATH instead.  4DOS will search for _CDPATH first;
  855.           when it is found, 4DOS will use it, and ignore CDPATH.
  856.  
  857.  
  858.       DESQview (Quarterdeck):
  859.  
  860.           Most information about DESQview is in chapter 7 of the manual.
  861.  
  862.           4DOS 4.0 automatically "cleans up" its resources (releases the
  863.           shell number and deletes any disk swap file) when you Close a
  864.           DESQview window from the DESQview menu without EXITing from 4DOS. 
  865.           However this feature has a side effect:  it disables the Quit
  866.  
  867.  
  868.  
  869.    4DOS 4.02  [3-30-93]          APPNOTES.DOC                       page 15
  870.  
  871.  
  872.           option on the DESQview menu (this is due to the design of
  873.           DESQview, not to anything within 4DOS).  4DOS gives you control
  874.           over this behavior with the DVCleanup directive in 4DOS.INI.  If
  875.           DVCleanup is set to Yes (the default), 4DOS will work as it did
  876.           in version 4.0.  Setting DVCleanup to No will disable 4DOS's
  877.           DESQview close window cleanup code and thereby reenable the Quit
  878.           choice on the menu.  However this will prevent 4DOS from cleaning
  879.           up its resources when you Close a 4DOS window from the menu,
  880.           rather than with the EXIT command.
  881.  
  882.    4.02   Some users report that DESQview uses all upper memory space when
  883.           it loads, leaving no upper memory available to 4DOS.  If you have
  884.           UMBLoad and / or UMBEnvironment set to Yes in 4DOS.INI, this will
  885.           result in a couple of harmless error messages when 4DOS is
  886.           started under DESQview.  To eliminate these messages, place the
  887.           following lines at the end of 4DOS.INI:
  888.  
  889.                     [Secondary]
  890.                     UMBLoad = No
  891.                     UMBEnnvironment = No
  892.  
  893.           DESQview includes the ability to assign "logical drives" to
  894.           subdirectory paths to make access to commonly used directories
  895.           easier, or to support older applications that can't handle
  896.           subdirectories.  This is similar to the DOS SUBST command.  4DOS
  897.           commands like DIR and COPY may not work as you expect on DESQview
  898.           logical drives, because DESQview does not support certain
  899.           standard DOS calls which 4DOS uses to determine whether a name
  900.           you enter is the name of a file or a subdirectory.  If you are
  901.           using specific filenames without wildcards, 4DOS commands will
  902.           generally work properly on DESQview logical drives.  However
  903.           problems may occur with "implied wildcards" (for example, when
  904.           4DOS interprets DIR A* as DIR A*.*), filename completion, and
  905.           other wildcard file access.  We know of no circumstances where
  906.           these problems would cause a loss of data.  However for the sake
  907.           of safety, when using DESQview logical drives we suggest you use
  908.           the /N switches on commands like COPY and MOVE to verify the
  909.           command's operation before files are actually modified.
  910.  
  911.           Under 4DOS, the DESQview DOS Services option will not work in its
  912.           default configuration.  To make DOS Services work under 4DOS, you
  913.           must first create a batch file, DOSSERV.BAT, in your DESQview
  914.           directory to run DOS Services under COMMAND.COM.  (We are
  915.           assuming that DESQview is in directory C:\DV and COMMAND.COM is
  916.           in directory C:\; you will need to modify the settings below if
  917.           your system is configured differently.)  The batch file is:
  918.  
  919.                     set comspec=c:\command.com
  920.                     c:\dv\dosserv
  921.                     c:\command
  922.                     exit
  923.  
  924.  
  925.  
  926.  
  927.    4DOS 4.02  [3-30-93]          APPNOTES.DOC                       page 16
  928.  
  929.  
  930.           Then, make the following changes on the DESQview change a program
  931.           screen for DOS Services (items marked ** are on the second page
  932.           of the screen):
  933.  
  934.                     *   Memory Allocation = 128K or greater
  935.                     *   Program Name = C:\DV\DOSSERV.BAT (modify from
  936.                         previous value of C:\DV\DOSSERV).
  937.                     **  Close on Exit to DOS = N
  938.                     **  System Memory = 10K or greater
  939.                     **  Allow Close Window = N
  940.  
  941.           Once these steps are taken, you should be able to open the DOS
  942.           Services window normally.  However you will not be able to close
  943.           it with a close window command.  Instead, go to the window where
  944.           DOS Services allows you to compose a DOS command, and type EXIT
  945.           to close the window.
  946.  
  947.  
  948.       DOORWAY BBS Software:
  949.  
  950.           DOORWAY uses the caret [^] in certain command line arguments. 
  951.           4DOS will interpret this symbol as a command separator, and will
  952.           not pass the line to DOORWAY properly.  You can work around this
  953.           problem by changing your 4DOS command separator permanently (with
  954.           the CommandSep directive in 4DOS.INI) or temporarily when
  955.           starting DOORWAY (with the SETDOS /C command), or by using the
  956.           4DOS escape character (ctrl-X) before each caret in the DOORWAY
  957.           command line.
  958.  
  959.  
  960.       DR-DOS (Digital Research):
  961.  
  962.           4DOS will work properly as a command processor (including as the
  963.           primary shell) under DR-DOS 3.4, 5.0, or 6.0.  The information
  964.           below was developed by testing 4DOS under DR-DOS 5.0 and 6.0.
  965.  
  966.           Internal vs. External Commands:
  967.  
  968.               DR-DOS 5.0's design makes the ASSIGN, JOIN, MORE, and SUBST
  969.               commands internal (in MS-DOS / PC-DOS they are external). 
  970.               4DOS supports all MS-DOS internal commands, but does not have
  971.               internal support for ASSIGN, JOIN, MORE, and SUBST.  To
  972.               access these DR-DOS internal commands when using 4DOS as the
  973.               command processor, you must set up aliases which run DR-DOS's
  974.               COMMAND.COM.  The following 4DOS aliases accomplish this
  975.               (adjust these if COMMAND.COM is not in C:\):
  976.  
  977.                     alias assign `c:\command /c assign %&`
  978.                     alias join `c:\command /c join %&`
  979.                     alias more `c:\command /c more %&`
  980.                     alias subst `c:\command /c subst %&`
  981.  
  982.  
  983.  
  984.  
  985.    4DOS 4.02  [3-30-93]          APPNOTES.DOC                       page 17
  986.  
  987.  
  988.               In DR-DOS 6.0 ASSIGN, JOIN, and SUBST were changed back to
  989.               external commands, so the corresponding aliases are not
  990.               necessary.
  991.  
  992.               For the MORE command, a much better alternative can be set up
  993.               by aliasing it to the 4DOS LIST command:
  994.  
  995.                     alias more list /s
  996.  
  997.               This provides a scrollable, full-screen display rather than
  998.               the simple paged display offered by DR-DOS (or MS-DOS) MORE.
  999.  
  1000.           HILOAD:
  1001.  
  1002.               4DOS supports DR-DOS's HILOAD feature using the MS-DOS / PC-
  1003.               DOS command names of LOADHIGH or LH.  To load a TSR high
  1004.               under DR-DOS, simply use the command:
  1005.  
  1006.                     LH [programname] [options]
  1007.  
  1008.               If you want the command to be called HILOAD for complete DR-
  1009.               DOS compatibility, just set up an alias before using it:
  1010.  
  1011.                     alias hiload lh
  1012.  
  1013.               Just as under MS-DOS, LOADHIGH and LH will not work properly
  1014.               unless you have memory management software loaded to provide
  1015.               upper memory block support.  Because DR-DOS does not return
  1016.               any error to 4DOS if a LOADHIGH operation fails, 4DOS cannot
  1017.               report this condition to you.  This means you must use the
  1018.               DR-DOS MEM program or another similar memory mapping utility
  1019.               to determine if your TSR was actually loaded high.
  1020.  
  1021.    4.02       The MS-DOS 6.0 switches for the 4DOS LH command (/L and /S)
  1022.               will not work with DR-DOS.
  1023.  
  1024.           File Passwords:
  1025.  
  1026.               4DOS includes support for DR-DOS file passwords.  However the
  1027.               command syntax used to access files with passwords is
  1028.               slightly different than under DR-DOS.
  1029.  
  1030.               First, the character used to separate passwords from
  1031.               filenames under DR-DOS is a semicolon [;], which 4DOS uses to
  1032.               separate parts of an "include list" (see the manual for
  1033.               details).  Therefore, a slightly different syntax must be
  1034.               used when including a DR-DOS password in a 4DOS internal
  1035.               command which accepts wildcards:  TWO semicolons should be
  1036.               used to separate the password and filename.  4DOS directory-
  1037.               related commands like MD and CD do not use wildcards and
  1038.               therefore a single semicolon should be used before a password
  1039.               in these commands.  All other 4DOS commands which accept
  1040.  
  1041.  
  1042.  
  1043.    4DOS 4.02  [3-30-93]          APPNOTES.DOC                       page 18
  1044.  
  1045.  
  1046.               wildcards must use the double semicolon.  DR-DOS external
  1047.               commands which accept the "password;filename" syntax will
  1048.               still use only a single semicolon.
  1049.  
  1050.               Second, DR-DOS hides files which are password-protected. 
  1051.               This means that you must use 4DOS command switches which
  1052.               allow processing of hidden files (COPY /H, DEL /Z, DIR /A,
  1053.               MOVE /H, and SELECT /A) to access a password-protected file
  1054.               under DR-DOS.
  1055.  
  1056.               Passwords are not automatically preserved when copying or
  1057.               moving a file with 4DOS.  However the hidden attribute will
  1058.               be preserved.  This means that if you move or copy a
  1059.               passworded file and want it to be visible in its new location
  1060.               or under its new name, you will have to manually remove the
  1061.               hidden attribute with ATTRIB.
  1062.  
  1063.               For example, to password-protect the file JUNK, copy it to
  1064.               drive A:, and then delete it:
  1065.  
  1066.                     password junk /r:fred
  1067.                     copy /h junk;;fred a:
  1068.                     del /z junk;;fred
  1069.  
  1070.               To unprotect the password-protected file JUNK:
  1071.  
  1072.                     password junk;fred /n
  1073.  
  1074.           CONFIG.SYS SETs:
  1075.  
  1076.               DR-DOS allows you to put SET commands in CONFIG.SYS to set
  1077.               environment variables.  4DOS will retrieve this information
  1078.               and store it in the 4DOS environment, as DR-DOS COMMAND.COM
  1079.               does.  If you wish you can disable this feature by setting
  1080.               DRSets = No in 4DOS.INI.
  1081.  
  1082.           SuperStor:
  1083.  
  1084.    4.02       The version of SuperStor shipped with DR-DOS works well with
  1085.               4DOS.  However some users report that 4DOS.COM cannot be
  1086.               stored on a compressed drive, and that if it is, DR-DOS will
  1087.               not be able to find 4DOS during the boot process.  If you
  1088.               experience this problem, store 4DOS on your uncompressed boot
  1089.               drive instead.
  1090.  
  1091.           TASKMAX:
  1092.  
  1093.               4DOS will work with TASKMAX as long as you start new tasks
  1094.               according to the instructions below.
  1095.  
  1096.               You cannot load 4DOS's resident portion high with UMBLoad =
  1097.               Yes in your 4DOS.INI file when running TASKMAX.  TASKMAX will
  1098.  
  1099.  
  1100.  
  1101.    4DOS 4.02  [3-30-93]          APPNOTES.DOC                       page 19
  1102.  
  1103.  
  1104.               hang the system if it is started while 4DOS is loaded high. 
  1105.               In our tests we have found that the same restriction does not
  1106.               apply to the UMBEnvironment directive, which does appear to
  1107.               be compatible with TASKMAX.  Some users also report that
  1108.               UMBLoad = Yes will work for secondary shells but not for the
  1109.               primary shell; the exact behavior appears to depend on your
  1110.               system and DR-DOS configuration.
  1111.  
  1112.               When TASKMAX is loaded it leaves the primary command
  1113.               processor running as task 1.  One way to start another task
  1114.               is to pop up TASKMAX and press Ins.  This starts another
  1115.               "instance" of the primary command processor, and may cause
  1116.               significant problems with 4DOS.  The reason is that each task
  1117.               started in this way is a copy of the primary command
  1118.               processor, so all such tasks will use the same swap area. 
  1119.               This will make changes to things like aliases, history, and
  1120.               SETDOS settings in one task "bleed through" to other tasks. 
  1121.               The exact nature of the bleed-through will depend on the
  1122.               sequence of operations and the type of 4DOS swapping you use. 
  1123.               This bleed-through will not necessarily hang your system but
  1124.               it may lead to very strange and undesired results, especially
  1125.               when running batch files simultaneously in more than one
  1126.               task.  There is no way for 4DOS to detect or prevent this
  1127.               condition.  We strongly recommend that you do NOT use Ins to
  1128.               start new 4DOS tasks, even if it temporarily appears to work
  1129.               properly on your system.
  1130.  
  1131.               Fortunately TASKMAX offers another way to start new tasks: 
  1132.               the TASKMAX /C command.  When executed from task 1, a command
  1133.               like:
  1134.  
  1135.                     taskmax /c c:\4dos.com
  1136.  
  1137.               will start a new secondary copy of 4DOS as a new task.  This
  1138.               new copy is a true secondary shell (not a copy of the primary
  1139.               shell) and will not cause the undesirable interactions
  1140.               described above.  The same approach should be used when
  1141.               starting any task which needs a command processor.  To start
  1142.               a task which runs a .BTM or .BAT file, use a command like
  1143.               this:
  1144.  
  1145.                     taskmax /c c:\4dos.com /c startwp.bat
  1146.  
  1147.               This tells 4DOS to run the specified batch file, and exit
  1148.               automatically (removing the task from the task list) when the
  1149.               batch file is done.
  1150.  
  1151.               If you have tasks you start regularly using the approach
  1152.               described above, use a batch file or a set of 4DOS aliases to
  1153.               help automate the process.
  1154.  
  1155.  
  1156.  
  1157.  
  1158.  
  1159.    4DOS 4.02  [3-30-93]          APPNOTES.DOC                       page 20
  1160.  
  1161.  
  1162.               Some users also report success at improving compatibility
  1163.               between TASKMAX and 4DOS if the FullINT2E directive is set to
  1164.               Yes in 4DOS.INI.  JP Software has not tested this approach
  1165.               but you may wish to experiment with it on your system.
  1166.  
  1167.  
  1168.       Epsilon (Lugaru Software):  [**]
  1169.  
  1170.           Epsilon can run 4DOS as a concurrent process, and pass commands
  1171.           to 4DOS for execution.  In this mode it traps 4DOS's input
  1172.           requests and feeds the keystrokes to 4DOS.  However it does not
  1173.           feed backspaces etc. -- only actual characters.  This means that
  1174.           editing of input isn't seen by 4DOS.  To fix the problem, either
  1175.           run 4DOS as a shell, and not as a concurrent process, or use a
  1176.           SETDOS /L1 for the copy of 4DOS that is run under Epsilon.  
  1177.  
  1178.           To use the more flexible SETDOS /L1 approach you must use
  1179.           4START.BAT (or .BTM) to set up the SETDOS /L1 before running
  1180.           Epsilon.  Epsilon sets the environment variable EPSRUNS=Y
  1181.           whenever it starts a secondary shell; you can use this variable
  1182.           to set up 4START to work with Epsilon.  Place the following line
  1183.           in 4START to issue the SETDOS /L1 command in a secondary shell
  1184.           started by Epsilon, but ignore it otherwise:
  1185.  
  1186.                     if "%epsruns"=="Y" setdos /l1
  1187.  
  1188.  
  1189.       Extra! 3270 Emulator:  [**]
  1190.  
  1191.    4.02   User reports indicate that Extra! will not work properly if 4DOS
  1192.           or the master environment is loaded high (in a UMB).  If you have
  1193.           trouble running Extra! with 4DOS, try removing any
  1194.           UMBEnvironment = Yes line in 4DOS.INI; if that doesn't help, try
  1195.           removing any UMBLoad = Yes line as well.
  1196.  
  1197.  
  1198.       FoxPro (Microsoft):  [**]
  1199.  
  1200.           FoxPro works well with 4DOS, but may have trouble if 4DOS or the
  1201.           master environment is loaded high (in a UMB).  If you experience
  1202.           compatibility problems between FoxPro and 4DOS, try removing any
  1203.           UMBEnvironment = Yes line in 4DOS.INI; if that doesn't help, try
  1204.           removing any UMBLoad = Yes line as well.
  1205.  
  1206.  
  1207.       Hijaak (Inset Systems):
  1208.  
  1209.           The Resident Program Manager (RPM) cannot be loaded from Hijaak's
  1210.           menu when 4DOS is the command processor.  If you try to load RPM
  1211.           from the menu you will receive "Out of memory" errors once it is
  1212.           loaded.  This is due to the internal design of Hijaak and is not
  1213.           a 4DOS bug.  To work around this problem, use the LOADRPM command
  1214.  
  1215.  
  1216.  
  1217.    4DOS 4.02  [3-30-93]          APPNOTES.DOC                       page 21
  1218.  
  1219.  
  1220.           from the 4DOS prompt, as described in the Hijaak manual.  LOADRPM
  1221.           will load RPM with no trouble under 4DOS, the problem occurs when
  1222.           loading from the Hijaak menu only.
  1223.  
  1224.  
  1225.       LapLink (Traveling Software):  [**]
  1226.  
  1227.    4.02   LapLink's "self-cloning" feature is not compatible with 4DOS's
  1228.           CTTY command.  If you need to use the self-cloning feature, start
  1229.           a temporary copy of COMMAND.COM first (see "Running 4DOS along
  1230.           with COMMAND>COM" at the beginning of this file for details).
  1231.  
  1232.  
  1233.       LOGIMENU (Logitech):  [**]
  1234.  
  1235.           When using Logitech's LOGIMENU with 4DOS, LOGIMENU may leave a
  1236.           file open each time a menu is unloaded.  Some users have been
  1237.           able to work around this problem by loading the menu from a
  1238.           floppy disk or RAM disk rather than the hard disk, but in general
  1239.           you will probably need to load and unload LOGIMENU with a product
  1240.           like MARK and RELEASE (from TurboPower's freeware TSRCOM package,
  1241.           available on the 4DOS Utility Disk), which can help to clean up
  1242.           files left open by other programs.
  1243.  
  1244.  
  1245.       Manifest (Quarterdeck):
  1246.  
  1247.           Manifest generally works well with 4DOS.  However if there is too
  1248.           little environment space free in 4DOS's master environment, the
  1249.           Hints Detail screen in Manifest may give unexpected results or
  1250.           hang your system.  If this occurs, increase your environment size
  1251.           and / or remove some environment variables when starting Manifest
  1252.           if you plan to use the Hints Detail screen.
  1253.  
  1254.  
  1255.       Netware (Novell):  [**]
  1256.  
  1257.           The information below was obtained from tests with Netware
  1258.           versions 2.12, 2.15, and 3.11 - 3.2, and Netware 386, and from
  1259.           discussions with Novell support personnel.
  1260.  
  1261.           Compatibility problems between Netware and 4DOS should be quite
  1262.           rare.  When they do occur, the usual problem is a conflict
  1263.           between 4DOS and the Netware shell (NET3, NET4, NET5, NETX,
  1264.           EMSNETX, etc.).  As a general rule, you should find that Novell's
  1265.           newer "NETX" shell versions have considerably fewer problems than
  1266.           the older NET3 / NET4 / NET5 versions, and we recommend their use
  1267.           with 4DOS whenever possible.
  1268.  
  1269.           4DOS includes a 4DOS.INI directive for Netware, NetwareNames. 
  1270.           You should always set NetwareNames = Yes on Netware systems. 
  1271.           This will include strings in the resident portion of 4DOS which
  1272.  
  1273.  
  1274.  
  1275.    4DOS 4.02  [3-30-93]          APPNOTES.DOC                       page 22
  1276.  
  1277.  
  1278.           Netware searches for when it loads, and thereby avoid problems
  1279.           with destroyed environment variables during LOGIN.  Setting
  1280.           NetwareNames = Yes will increase the resident size of 4DOS by 112
  1281.           bytes.
  1282.  
  1283.           If you use NetwareNames = Yes and UMBLoad = Yes, and you do not
  1284.           actually have any upper memory blocks available, then
  1285.           NetwareNames will be ignored, and you may see problems with your
  1286.           environment after using LOGIN.  To correct this, do not use
  1287.           UMBLoad with NetwareNames unless you have enough space in upper
  1288.           memory for the resident portion of 4DOS.  See your 4DOS manual
  1289.           for more information on UMBLoad.
  1290.  
  1291.           [CAUTION:  If NetwareNames is set to Yes and you BOOT FROM a
  1292.           Netware drive (a rare situation), the TEMP4DOS or TEMP variables
  1293.           must be SET explicitly to the appropriate drive and directory for
  1294.           each user to avoid conflicts in the directory used for pipe
  1295.           files.  If NetwareNames is not used or you boot from a local
  1296.           drive, 4DOS and Netware will automatically set the proper drive
  1297.           and directory for pipe files.]
  1298.  
  1299.    4.02   Under Netware version 3 and above, 4DOS commands which scan a
  1300.           directory tree (e.g. COPY /S, DIR /S, GLOBAL, etc.) may stop
  1301.           without scanning the entire tree, and without displaying an error
  1302.           message.  This is because such commands can exceed the size of
  1303.           the directory search table on your server; it is a Netware design
  1304.           issue, and not a 4DOS bug.  You can address any such problem by
  1305.           having your system administrator increase the Maximum Oustanding
  1306.           NCP Searches parameter for the server in question.  This
  1307.           parameter is documented in the Netware System Administrator's
  1308.           manual, Console Set Parameters section, under Miscellaneous
  1309.           Advanced parameters.  The default value is 51, the minimum is 10,
  1310.           and the maximum is 1000.  The parameter can be set "on the fly"
  1311.           without restarting the server.
  1312.  
  1313.    4.02   4DOS can be set up to run properly on Novell Netware diskless
  1314.           workstations which boot from the server.  To do so, you must make
  1315.           several changes to 4DOS.INI and your other startup files.  JP
  1316.           Software has a separate technical document on the steps required. 
  1317.           If you need a copy, contact us and we will mail it to you.  You
  1318.           can also download a copy from our CompuServe support area; the
  1319.           file name is DISKLS.ZIP.
  1320.  
  1321.           Some versions of Netware may occasionally produce a "pipe not
  1322.           found" message when loading under 4DOS.  This message refers to
  1323.           Netware features related to COMMAND.COM, and does not apply to
  1324.           4DOS; the message can be ignored.
  1325.  
  1326.           The 4DOS TRUENAME command and the @TRUENAME variable function
  1327.           will return true Netware server names when given a file name that
  1328.           refers to a Netware drive.  However the returned name will not be
  1329.           correct if only the root directory name is given as a parameter
  1330.  
  1331.  
  1332.  
  1333.    4DOS 4.02  [3-30-93]          APPNOTES.DOC                       page 23
  1334.  
  1335.  
  1336.           (for example TRUENAME K:\).  This is because Netware fails to
  1337.           recognize the true name request properly when only a root
  1338.           directory name is given; it is not a bug in 4DOS.  If necessary,
  1339.           you can work around this problem by adding a simple "." to the
  1340.           request (TRUENAME K:\.).
  1341.  
  1342.           If you use 4DOS input redirection in a .BAT file which resides on
  1343.           a Netware drive, you may experience incorrect file assignments on
  1344.           some systems.  When this occurs, an application run from within
  1345.           the batch file, or a secondary shell run from such an
  1346.           application, may loop forever attempting to read lines from the
  1347.           batch file rather than accepting input from the keyboard.  For
  1348.           example:
  1349.  
  1350.                     copy /r *.* g: < YES
  1351.                     wp
  1352.                     rem  Now if the user shells from WP, the system will
  1353.                     rem  loop forever reading lines from the batch file or
  1354.                     rem  blank lines at the prompt.
  1355.  
  1356.           This problem occurs because Netware does not handle file
  1357.           assignments properly when 4DOS input redirection is used in a
  1358.           .BAT file.  We are working with Novell to attempt to resolve the
  1359.           problem.  You can work around it in several ways:
  1360.  
  1361.               * Change the batch file to a .BTM file.
  1362.  
  1363.               * Place the file BTM mode with the LOADBTM command at any
  1364.               point prior to the use of input redirection.
  1365.  
  1366.               * Move the file to a non-Netware drive.
  1367.  
  1368.               * User reports indicate that adding a line which does a
  1369.               "dummy" output redirection just before the input redirection
  1370.               will prevent the problem from occurring.  For example:
  1371.  
  1372.                     echo This is junk > junk.dat
  1373.                     copy /r *.* g: < YES
  1374.                     wp
  1375.                     del junk.dat
  1376.  
  1377.           When loading a secondary 4DOS shell under Netware you can swap
  1378.           the shell to a network drive if you configure 4DOS properly.  To
  1379.           do so you must take into account the fact that Netware closes all
  1380.           files -- including the 4DOS swap file -- each time an application
  1381.           exits.  Under the default 4DOS configuration, the next time 4DOS
  1382.           uses the swap file, a swap file seek error will occur.  However
  1383.           if you set SwapReopen = Yes in 4DOS.INI, 4DOS will reopen its
  1384.           swap file each time such an error occurs, and the swapping will
  1385.           work.  See the manual for details on SwapReopen.  You can also
  1386.           avoid this problem by swapping to EMS, XMS, or a local hard disk
  1387.           or RAM disk.
  1388.  
  1389.  
  1390.  
  1391.    4DOS 4.02  [3-30-93]          APPNOTES.DOC                       page 24
  1392.  
  1393.  
  1394.           Use caution with the 4DOS UNSET command under Netware.  When
  1395.           Netware is loaded it remembers the exact location of the COMSPEC
  1396.           variable in the master environment, and it may therefore have
  1397.           problems if variables such as COMSPEC and PATH are removed and
  1398.           reloaded in a different sequence.
  1399.  
  1400.           The UMBLoad directive in 4DOS.INI is compatible with Netware. 
  1401.           The UMBEnvironment directive is compatible with Netware 3.11 and
  1402.           above, but not with earlier versions.
  1403.  
  1404.  
  1405.       Novell MENU (Novell):
  1406.  
  1407.           The Novell MENU system distributed with Netware uses Interrupt 2E
  1408.           to execute menu options, and therefore requires the use of the
  1409.           FullINT2E = Yes directive in 4DOS.INI.  Once INT 2E support is
  1410.           enabled with this directive, Novell MENU should work normally
  1411.           under 4DOS.
  1412.  
  1413.  
  1414.       OS/2 1.2, 1.3, and 2.0 (IBM / Microsoft):
  1415.  
  1416.           4DOS works properly as the shell in OS/2 DOS sessions under OS/2
  1417.           1.2, 1.3, and 2.0.  When installing OS/2's dual boot option you
  1418.           may receive a warning because your SHELL command in CONFIG.SYS
  1419.           points to 4DOS rather than COMMAND.COM.  In our experience this
  1420.           warning can be ignored, and OS/2 will install properly.
  1421.  
  1422.    4.02   If you see a message like "Cannot find OSO001.MSG" when running
  1423.           external utilities like TREE or DISKCOPY in OS/2 DOS sessions,
  1424.           you probably need to include the line:
  1425.  
  1426.                     loadhigh append c:\os2;c:\os2\system
  1427.  
  1428.           in your AUTOEXEC.BAT file used by these DOS sessions, or set up
  1429.           the append path in an alias or batch file used to run such
  1430.           programs (change the drive letter if OS/2 is installed on a
  1431.           different drive).  Be sure to read the notes and cautions on
  1432.           MS-DOS APPEND in this file before using APPEND.
  1433.  
  1434.           If you use OS/2, you will probably want to use our companion
  1435.           product 4OS2 in your OS/2 sessions.  See the ORDERINF.DOC file
  1436.           for more information.  The 4OS2 manual also includes detailed
  1437.           information on fine-tuning 4DOS for use in your OS/2 DOS
  1438.           sessions.
  1439.  
  1440.  
  1441.       OS2SPEED DOS Sessioon Enhancer:
  1442.  
  1443.  
  1444.  
  1445.  
  1446.  
  1447.  
  1448.  
  1449.    4DOS 4.02  [3-30-93]          APPNOTES.DOC                       page 25
  1450.  
  1451.  
  1452.           OS2SPEED is a small freeware program which is supposed to release
  1453.           unused CPU time in OS/2 DOS sessions when certain applications
  1454.           are running, and thereby improve performance.  It accomplishes
  1455.           this task by fooling DOS applications into thinking they are
  1456.           running under DESQview, then converting the applications'
  1457.           commands to release unused time to DESQview into similar commands
  1458.           for OS/2.
  1459.  
  1460.           Unfortunately, the version of OS2SPEED available as of this
  1461.           writing is flawed because it provides only a partial emulation of
  1462.           DESQview, and can cause "DESQview-aware" applications -- like
  1463.           4DOS -- to crash the DOS session.  We recommend that you use
  1464.           OS/2's IDLE_SECONDS and IDLE_SENSITIVITY DOS settings to adjust
  1465.           DOS session performance.  If you must use OS2SPEED, you may be
  1466.           able to make it work properly with 4DOS by disabling 4DOS's
  1467.           DESQview awareness with this directive in 4DOS.INI:
  1468.  
  1469.                     DVCleanup = No
  1470.  
  1471.  
  1472.       Personal REXX (Quercus Systems):  [**]
  1473.  
  1474.           Personal REXX generally works well with 4DOS.  However there are
  1475.           some issues you must take into account when using certain
  1476.           personal REXX features.
  1477.  
  1478.           The Personal REXX Batch Manager will not work with 4DOS as the
  1479.           command processor.  The Batch Manager allows REXX programs to be
  1480.           executed from the command line without requiring a REXX or RX
  1481.           command prefix.  The Batch Manager accomplishes this by using an
  1482.           undocumented feature of COMMAND.COM, and Mansfield Software
  1483.           states that this may not work on OEM versions of DOS, and advises
  1484.           that if it does not work, you should not use it.  To work around
  1485.           this problem, use executable extensions to tell 4DOS to execute
  1486.           .REX files using REXX.EXE.  To set this up, add a command like
  1487.           this to your AUTOEXEC.BAT file:
  1488.  
  1489.                     set .rex=d:\path\rexx.exe
  1490.  
  1491.           where "d:\path" is the drive and directory where REXX.EXE is
  1492.           stored.  Once this executable extension is set up, REXX programs
  1493.           will run as though the Batch Manager was installed.  Note,
  1494.           however, that the Batch Manager would attempt the execution of
  1495.           REXX programs before .BAT files, whereas 4DOS executable
  1496.           extensions are executed after .BTM and .BAT files.
  1497.  
  1498.           Personal REXX also provides the ADDRESS DOS statement, which
  1499.           allows the REXX program to pass commands to the DOS command
  1500.           processor.  This function is implemented through the undocumented
  1501.           INT 2E interface to the command processor, which can be enabled
  1502.           in 4DOS with the FullINT2E=Yes directive in 4DOS.INI.  If you use
  1503.           FullINT2E=Yes and have trouble with ADDRESS DOS, use Personal
  1504.  
  1505.  
  1506.  
  1507.    4DOS 4.02  [3-30-93]          APPNOTES.DOC                       page 26
  1508.  
  1509.  
  1510.           REXX's OPTIONS NEWCOM, or an environment variable, SET
  1511.           RXNEWCOM=YES, to force ADDRESS DOS to shell to a new copy of
  1512.           4DOS.  Note that the normal Personal REXX ADDRESS DOS function
  1513.           permits the environment to be permanently modified, whereas using
  1514.           OPTIONS NEWCOM, or setting the environment variable will not
  1515.           permit this.  Quercus Systems discourages the use of the INT 2E
  1516.           approach in DOS 4.00 or later, and Personal REXX will default to
  1517.           not using INT 2E with these versions of DOS.
  1518.  
  1519.  
  1520.       QEMM and QRAM (Quarterdeck):
  1521.  
  1522.           The information below was obtained from tests with QEMM versions
  1523.           5 and 6, and user reports on QRAM.
  1524.  
  1525.           Both QEMM and QRAM are compatible with 4DOS, and will allow you
  1526.           to load the 4DOS resident code and the master environment into
  1527.           high DOS memory (UMBs) via the UMBLoad and UMBEnvironment
  1528.           directives in 4DOS.INI.  For these directives to work with QRAM
  1529.           you must have QEXT loaded also (this is the normal method of
  1530.           loading QRAM).
  1531.  
  1532.           QEMM's Stealth mode is compatible with 4DOS, but can decrease
  1533.           general system stability on some systems.  If you have unusual
  1534.           problems or system hangs with Stealth turned on, try turning it
  1535.           off and see if the problems clear up (this is the procedure
  1536.           recommended by Quarterdeck in their Stealth documentation).
  1537.  
  1538.           QEMM allocates both XMS and EMS memory from the same memory area. 
  1539.           Therefore it always reports the exact same amount of free XMS and
  1540.           EMS memory.  You will see this in the free EMS and free XMS
  1541.           values displayed by the 4DOS MEMORY command -- they will be
  1542.           exactly the same under QEMM.  Just remember that if both values
  1543.           are (say) 512K, that means you have 512K of free memory which can
  1544.           be allocated either way -- not 1024K!
  1545.  
  1546.           If you use FILES.COM to load part of the DOS file handle table
  1547.           into high memory, you must follow Quarterdeck's recommendations
  1548.           and keep a minimum of FILES=8 in CONFIG.SYS.  Lower values may
  1549.           cause 4DOS to hang during boot, especially if disk swapping is
  1550.           used.
  1551.  
  1552.           If you use QEMM's OPTIMIZE and your AUTOEXEC has 4DOS-specific
  1553.           commands like GLOBAL, IFF, aliases, etc., OPTIMIZE will recognize
  1554.           them based on the 4DOS.CMD file distributed with QEMM 6.  Note
  1555.           that in QEMM version 6.00 this file is incomplete in that it does
  1556.           not include the ELSE, ELSEIFF, and ENDIFF commands; you should
  1557.           add these commands to 4DOS.CMD if you use them in your AUTOEXEC
  1558.           file.  This error in 4DOS.CMD was corrected in version 6.01 of
  1559.           QEMM.  To use 4DOS.CMD it must be renamed to OPTIMIZE.EXC before
  1560.           running OPTIMIZE; see your QEMM documentation for details.
  1561.  
  1562.  
  1563.  
  1564.  
  1565.    4DOS 4.02  [3-30-93]          APPNOTES.DOC                       page 27
  1566.  
  1567.  
  1568.           OPTIMIZE cannot take account of the fact that 4DOS may be loaded
  1569.           high with UMBLoad = Yes in 4DOS.INI, and therefore may not give
  1570.           the best optimization results when UMBLoad = Yes is used
  1571.           (OPTIMIZE has this problem with all programs which load
  1572.           themselves into UMBs, not just with 4DOS).  Some users also
  1573.           report that OPTIMIZE is unstable on their systems when UMBLoad =
  1574.           Yes is used.
  1575.  
  1576.  
  1577.       RBase (MicroRim):  [**]
  1578.  
  1579.           When used with 4DOS disk swapping, RBase closes 4DOS's swap file
  1580.           when it exits.  This generates "4DOS Unrecoverable error DS" and
  1581.           other similar fatal error messages.  You can avoid this problem
  1582.           by changing 4DOS swapping to go to EMS or XMS, or by setting
  1583.           SwapReopen = Yes in 4DOS.INI.
  1584.  
  1585.  
  1586.       RoboComm Communications Software:  [**]
  1587.  
  1588.           If you have trouble shelling out of RoboComm (for example, to use
  1589.           an external protocol like DSZ), try increasing the setting for
  1590.           Files and Extract memory to 256K.
  1591.  
  1592.  
  1593.       Software Carousel (SoftLogic Solutions):
  1594.  
  1595.           Please see the general section on multitaskers in chapter 7 of
  1596.           the manual before reading this section.
  1597.  
  1598.           The information below was obtained from tests with Software
  1599.           Carousel version 3, and discussions with SoftLogic technical
  1600.           support.  It applies to all versions of Software Carousel.
  1601.  
  1602.           Software Carousel will not work properly with 4DOS loaded as the
  1603.           primary shell.  It is designed with the assumption that
  1604.           COMMAND.COM is the system command processor, and contains logic
  1605.           which specifically depends on COMMAND.COM and the way it is
  1606.           written, and which actually modifies the copy of COMMAND.COM in
  1607.           memory.  This makes it impossible to write a program which works
  1608.           properly as an alternate command processor loaded underneath
  1609.           (i.e. before) Software Carousel.
  1610.  
  1611.           However, 4DOS can be run without difficulty inside a Software
  1612.           Carousel partition, if the instructions below are followed.
  1613.  
  1614.           When loading 4DOS into a Carousel partition, the best method is
  1615.           to leave the COMSPEC set to COMMAND.COM when Carousel is loaded. 
  1616.           4DOS should then be set up in the Carousel options file just like
  1617.           any other program.  For example, to load 4DOS into partition 1:
  1618.  
  1619.                     d:\path\4DOS.COM [parameters] [filename]
  1620.  
  1621.  
  1622.  
  1623.    4DOS 4.02  [3-30-93]          APPNOTES.DOC                       page 28
  1624.  
  1625.  
  1626.           where:
  1627.  
  1628.               d:\path         is the drive and path where 4DOS.COM is
  1629.                               located
  1630.  
  1631.               [parameters]    is any 4DOS command line parameters (/E,
  1632.                               @ininame, etc.; do NOT use /P here)
  1633.  
  1634.               [filename]      is the name of a batch file to be executed
  1635.                               when the partition is started
  1636.  
  1637.           To use different 4DOS.INI files for different Software Carousel
  1638.           partitions, use the "@ininame" parameter in the "parameters"
  1639.           section of your Carousel setup to invoke a specific file.  For
  1640.           example, the parameters could be set to @D:\WP\4DOSWP.INI to use
  1641.           that initialization file for the WP partition.
  1642.  
  1643.           Because 4DOS can only be loaded in a partition when running
  1644.           Software Carousel, and not as the primary command processor,
  1645.           using 4DOS disk swapping in multiple partitions is subject to the
  1646.           cautionary note on this subject in the general information
  1647.           section on multitaskers in the manual; please read it carefully. 
  1648.           As stated in that note, if you use disk swapping you will
  1649.           probably want to use the UniqueSwapName directive in 4DOS.INI to
  1650.           avoid swap file name conflicts.
  1651.  
  1652.  
  1653.       TSRCOM Utilities (TurboPower Software):
  1654.  
  1655.           The TSRCOM utilities will work properly with 4DOS as long as you
  1656.           use TSRCOM version 2.6 or later.  The current release is version
  1657.           3.4, and is available on the 4DOS Utility Disk and on many
  1658.           bulletin boards and on-line systems.
  1659.  
  1660.           If you use TSRCOM's MARK and RELEASE to manage your TSRs, 4DOS
  1661.           swapping (as set with the SWAPPING command) must be in the same
  1662.           state when RELEASE is run as it was when MARK (or FMARK) was run. 
  1663.           This is a characteristic of the design of MARK and RELEASE (or
  1664.           any other such products), and not a bug.  If you do not observe
  1665.           this rule (for example, if you run MARK with SWAPPING OFF in
  1666.           AUTOEXEC and later run RELEASE from the prompt with SWAPPING ON),
  1667.           you may receive unusual error messages or hang your system.  The
  1668.           same restriction applies to MARKNET and RELNET.
  1669.  
  1670.  
  1671.       UltraVision (Personics):
  1672.  
  1673.           The DE program distributed with UltraVision is written
  1674.           specifically for COMMAND.COM, and cannot be used to set directory
  1675.           colors with 4DOS.  Use 4DOS's built-in directory colorization
  1676.           instead.
  1677.  
  1678.  
  1679.  
  1680.  
  1681.    4DOS 4.02  [3-30-93]          APPNOTES.DOC                       page 29
  1682.  
  1683.  
  1684.       Windows 3.0 and 3.1 (Microsoft):
  1685.  
  1686.           Most information about Windows 3.0 is in chapter 7 of the manual. 
  1687.           4DOS has been tested thoroughly and works well with Windows 3.1;
  1688.           the instructions in the manual on Windows 3.0 also apply to
  1689.           Windows 3.1.  (See the section on PATH problems below for one
  1690.           caution related to the Setup Applications program in Windows
  1691.           3.0.)
  1692.  
  1693.    4.02   Under some circumstances you may find that Windows overrides the
  1694.           environment size specified in your 4DOS.INI file, and creates a
  1695.           smaller environment.  This can leave insufficient environment
  1696.           space for your 4DOS sessions running under Windows.  If you
  1697.           experience this problem, edit the SYSTEM.INI file in your Windows
  1698.           directory, and find the section labelled [NonWindowsApp].  Add
  1699.           the following line to this section:
  1700.  
  1701.                     CommandEnvSize = 0
  1702.  
  1703.           This tells Windows not to force a particular environment size,
  1704.           which will allow 4DOS to set the size itself.
  1705.  
  1706.           If you set up a PIF file for a 4DOS window, please note that the
  1707.           4DOS MEMORY command will report the maximum amount of EMS memory
  1708.           which Windows can theoretically make available in that window. 
  1709.           Because Windows provides a virtual memory capability, this number
  1710.           may be much larger than the size of physical RAM.  For example,
  1711.           if you set the EMS Limit in your PIF file to -1, Windows will
  1712.           report total EMS memory of 64 MB to 4DOS as this is the
  1713.           theoretical limit on Windows' virtual memory manager.  Virtual
  1714.           memory figures which give the appearance of excess memory are a
  1715.           feature of Windows, and not a bug in 4DOS.
  1716.  
  1717.  
  1718.       XyWrite (XyQuest):  [**]
  1719.  
  1720.           XyWrite's "shell to DOS" capability shells to COMMAND.COM, even
  1721.           if you have your COMSPEC variable set to 4DOS.  The only way we
  1722.           know of to work around the problem is to make a copy of 4DOS.COM
  1723.           and call it COMMAND.COM.  If you do this, be sure to save the
  1724.           real COMMAND.COM in another directory in case you need it for
  1725.           another purpose.  Some users have reported that the same problem
  1726.           occurs with Signature, a newer word processor from XyQuest.
  1727.  
  1728.  
  1729.       Programs Requiring PATH to be Under 128 Characters:
  1730.  
  1731.           The following programs contain bugs which prevent them from
  1732.           working properly if you have a PATH which is over 128 characters
  1733.           long.  Since 4DOS allows you to create a PATH up to 255
  1734.           characters long this can appear to be a conflict between the
  1735.           program involved and 4DOS.  If your path is longer than 128
  1736.  
  1737.  
  1738.  
  1739.    4DOS 4.02  [3-30-93]          APPNOTES.DOC                       page 30
  1740.  
  1741.  
  1742.           characters, see the section headed "Solving Software
  1743.           Compatibility Problems" in chapter 7 of the manual for
  1744.           information on creating a batch file to reduce the PATH length
  1745.           while one of these programs is running.
  1746.  
  1747.               Checkit (Touchstone):  [**]  Checkit version 3 requires a
  1748.               path length under 128 characters.
  1749.  
  1750.               Computer Select CD-ROM (Ziff-Davis):  [**]  Computer Select
  1751.               cannot find its help program if your PATH is over 128
  1752.               characters long.  
  1753.  
  1754.               RenderMan (AutoDesk):  RenderMan will hang your system if it
  1755.               is started with a PATH longer than 128 characters.
  1756.  
  1757.               VINES Network (Banyan):  [**]  VINES' installation may not
  1758.               work properly if your PATH is longer than 128 characters.
  1759.  
  1760.               Windows 3.0 (Microsoft):  The Windows 3 Setup Applications
  1761.               option, which scans your disk drives for applications to be
  1762.               added to Windows program groups, will not work properly if
  1763.               your PATH is more than 128 characters long.  This problem is
  1764.               fixed in Windows 3.1.
  1765.  
  1766.  
  1767.  
  1768.  
  1769.  
  1770.  
  1771.  
  1772.  
  1773.  
  1774.  
  1775.  
  1776.  
  1777.  
  1778.  
  1779.  
  1780.  
  1781.  
  1782.  
  1783.  
  1784.  
  1785.  
  1786.  
  1787.  
  1788.  
  1789.  
  1790.  
  1791.  
  1792.  
  1793.  
  1794.  
  1795.  
  1796.  
  1797.    4DOS 4.02  [3-30-93]          APPNOTES.DOC                       page 31
  1798.  
  1799.  
  1800.  
  1801.    Software For Use With 4DOS
  1802.    --------------------------
  1803.  
  1804.    We receive many requests for recommendations on software that works well
  1805.    with 4DOS, or that we have found especially useful.
  1806.  
  1807.    While we can't recommend what will work well on your system or to meet
  1808.    your needs, we can tell you what packages we have used and found
  1809.    valuable.  We will confine our comments to our primary area of expertise
  1810.    -- system software -- and avoid discussing applications programs like
  1811.    spreadsheets and word processors.
  1812.  
  1813.    Please note that this is NOT actually a list of what works well with
  1814.    4DOS -- the answer to that is, almost everything!  And remember this is
  1815.    only our opinions -- you need to choose what will work best for you.
  1816.  
  1817.       Memory Managers:  We generally use 386MAX and BlueMax (Qualitas) on
  1818.       our own systems because we find it offers some important technical
  1819.       advantages, and takes a conservative approach to memory management. 
  1820.       This approach may leave slightly less memory available on some
  1821.       systems, but in our view this is a small price to pay for the
  1822.       increased reliability provided by more conservative memory management
  1823.       techniques.  Many 4DOS users also report excellent results with QEMM
  1824.       (Quarterdeck), and we use it at times as well.  We have less
  1825.       experience with other memory managers like Netroom (Helix) and Memory
  1826.       Commander (V Communications), so we can't comment on them.
  1827.  
  1828.       Task Switchers:  For switching between applications which run one at
  1829.       a time, the primary products we're aware of are Back & Forth
  1830.       (Progressive Solutions) and Software Carousel (SoftLogic).  This
  1831.       category is an exception to our "everything works well with 4DOS"
  1832.       rule:  Software Carousel does work with 4DOS, but is designed to
  1833.       depend on COMMAND.COM and requires special care when used with 4DOS
  1834.       (see above for details).  Back & Forth works seamlessly with 4DOS,
  1835.       and many 4DOS users are enthusiastic about its features, support, and
  1836.       price.  Back & Forth contains a number of features specifically
  1837.       created with 4DOS in mind (for example, it knows that .BTM files are
  1838.       executable like batch files), and JP Software and Progressive
  1839.       Solutions communicate regularly to make sure that 4DOS and Back &
  1840.       Forth continue to work well together.
  1841.  
  1842.       Disk Caches:  There are dozens of products available in this
  1843.       category.  We use Super PC-Kwik (MultiSoft), HyperDisk (Hyperware),
  1844.       and SmartDrive (Microsoft), and have found all of them to be reliable
  1845.       and to work well with 4DOS.  We can't speak from any direct
  1846.       experience about other caching programs.
  1847.  
  1848.       Disk Expanders:  We have had excellent results using Stacker (Stac
  1849.       Electronics) to expand disk drive space.  We currently run Stacker on
  1850.       both notebook and desktop systems.  We sometimes get a little less
  1851.       than Stac's claimed 2:1 disk space savings, but this is a minor point
  1852.  
  1853.  
  1854.  
  1855.    4DOS 4.02  [3-30-93]          APPNOTES.DOC                       page 32
  1856.  
  1857.  
  1858.       compared to Stacker's reliability, speed, and value.  We have also
  1859.       tested the DBLSPACE utility included with MS-DOS 6.0, and it works
  1860.       well with 4DOS 4.02.  We haven't used DBLSAPCE extensively enough to
  1861.       comment on its overall reliability.  There are other products which
  1862.       perform the same function; we have not used or evaluated any of them.
  1863.  
  1864.       Video Utilities:  We use UltraVision (Personics) regularly on all of
  1865.       our systems which have VGA video or better, and we use Laptop
  1866.       UltraVision on laptop or notebook systems.  UltraVision allows
  1867.       excellent control over all aspects of VGA and EGA video systems
  1868.       including fonts, colors, and screen sizes.  It is fully compatible
  1869.       with 4DOS and many 4DOS users have found it to be a valuable tool. 
  1870.       We are not aware of any other products which do what UltraVision
  1871.       does.  ANSI-UV.SYS which comes with UltraVision is an excellent ANSI
  1872.       driver; we also use ANSI.COM from PC Magazine.
  1873.  
  1874.       Boot Utilities:  We can't speak about this issue from any distance
  1875.       because we sell one such utility, BOOT.SYS, and use it on all our
  1876.       systems.  BOOT.SYS was the first of these utilities to allow
  1877.       selection of a configuration during the boot process, and is an
  1878.       excellent tool for configuration management.  There are other
  1879.       products in this category but we are not familiar with them.
  1880.  
  1881.  
  1882.  
  1883.  
  1884.  
  1885.  
  1886.  
  1887.  
  1888.  
  1889.  
  1890.  
  1891.  
  1892.  
  1893.  
  1894.  
  1895.  
  1896.  
  1897.  
  1898.  
  1899.  
  1900.  
  1901.  
  1902.  
  1903.  
  1904.  
  1905.  
  1906.  
  1907.  
  1908.  
  1909.  
  1910.  
  1911.  
  1912.  
  1913.    4DOS 4.02  [3-30-93]          APPNOTES.DOC                       page 33
  1914.  
  1915.